#極域グラフ

極面グラフは円グラフに似ていますが、各セグメントの角度は同じであり、セグメントの半径は値に応じて異なります。

このタイプのグラフは、円グラフに似た比較データを表示するだけでなく、コンテキストの値のスケールも表示する場合に便利です。

const config = {
  type: 'polarArea',
  data: data,
  options: {}
};

#データセットのプロパティ

名前空間:

  • data.datasets[index]- このデータセットのみのオプション
  • options.datasets.polarArea- すべてのpolarAreaデータセットのオプション
  • options.elements.arc- すべてのオプション円弧要素
  • options- チャート全体のオプション

次のオプションを極面グラフ データセットに含めて、その特定のデータセットのオプションを構成できます。

名前 タイプ スクリプト可能 インデックス可能 デフォルト
backgroundColor Color はい はい 'rgba(0, 0, 0, 0.1)'
borderAlign 'center'|'inner' はい はい 'center'
borderColor Color はい はい '#fff'
borderDash number[] はい - []
borderDashOffset number はい - 0.0
borderJoinStyle 'round'|'bevel'|'miter' はい はい undefined
borderWidth number はい はい 2
clip number|object|false - - undefined
data number[] - - 必要
hoverBackgroundColor Color はい はい undefined
hoverBorderColor Color はい はい undefined
hoverBorderDash number[] はい - undefined
hoverBorderDashOffset number はい - undefined
hoverBorderJoinStyle 'round'|'bevel'|'miter' はい はい undefined
hoverBorderWidth number はい はい undefined
circular boolean はい はい true

これらすべての値がundefined、で説明されているスコープにフォールバックします。オプションの解決策

#全般的

名前 説明
clip chartArea を基準にしてクリップする方法。正の値ではオーバーフローが許可され、負の値では chartArea 内の多くのピクセルがクリップされます。0= chartArea でクリップします。クリッピングは側面ごとに構成することもできます。clip: {left: 5, top: false, right: -2, bottom: 0}

#スタイリング

各円弧のスタイルは、次のプロパティで制御できます。

名前 説明
backgroundColor 円弧の背景色。
borderColor 円弧の境界線の色。
borderDash 円弧の境界線の長さとダッシュの間隔。見るMDN (新しいウィンドウが開きます)
borderDashOffset 破線の円弧境界オフセット。見るMDN (新しいウィンドウが開きます)
borderJoinStyle 円弧の境界線結合スタイル。見るMDN (新しいウィンドウが開きます)
borderWidth 円弧の境界線の幅 (ピクセル単位)。
circular デフォルトでは、円弧は曲線になっています。もしもcircular: false弧は平らになります。

これらすべての値がundefined、関連付けられたものへのフォールバックelements.arc.*オプション。

#境界線の配置

次の値がサポートされていますborderAlign

  • 'center'(デフォルト)
  • 'inner'

いつ'center'を設定すると、隣り合う円弧の境界線が重なり合います。いつ'inner'が設定されている場合、すべての境界線が重ならないことが保証されます。

#インタラクション

各アークとの相互作用は、次のプロパティで制御できます。

名前 説明
hoverBackgroundColor ホバー時の円弧の背景色。
hoverBorderColor ホバーしたときの円弧の境界線の色。
hoverBorderDash ホバーしたときの円弧の境界線の長さとダッシュの間隔。見るMDN (新しいウィンドウが開きます)
hoverBorderDashOffset ホバー時の破線の円弧境界線のオフセット。見るMDN (新しいウィンドウが開きます)
hoverBorderJoinStyle ホバー時の円弧境界結合スタイル。見るMDN (新しいウィンドウが開きます)
hoverBorderWidth ホバーしたときの円弧の境界線の幅 (ピクセル単位)。

これらすべての値がundefined、関連付けられたものへのフォールバックelements.arc.*オプション。

#設定オプション

これらは、極面グラフに固有のカスタマイズ オプションです。これらのオプションはアクセス時に検索され、グローバル チャートのデフォルト オプションチャートのオプション。

名前 タイプ デフォルト 説明
animation.animateRotate boolean true true の場合、チャートは回転アニメーションでアニメーション化されます。この物件はoptions.animation物体。
animation.animateScale boolean true true の場合、グラフを中心から外側に拡大縮小するアニメーションが表示されます。

極面グラフでは、ラジアルリニア規模。追加の構成はスケールを介して提供されます。

#デフォルトのオプション

作成される PolarArea タイプごとにこれらのデフォルト値を変更することもできます。このオブジェクトは次の場所で入手できます。Chart.overrides.polarArea。グローバル オプションを変更すると、変更後に作成されたグラフにのみ影響します。既存のチャートは変更されません。

たとえば、すべての新しい極面グラフを次のように設定するには、animateScale = falseあなたならこうします:

Chart.overrides.polarArea.animation.animateScale = false;

#データ構造

極面グラフの場合、データセットにはデータ ポイントの配列が含まれている必要があります。データ ポイントは数値である必要があり、Chart.js はすべての数値を合計し、それぞれの相対的な割合を計算します。

また、各スライスにツールヒントが正しく表示されるように、ラベルの配列を指定する必要があります。

data = {
    datasets: [{
        data: [10, 20, 30]
    }],
    // These labels appear in the legend and in the tooltips when hovering different arcs
    labels: [
        'Red',
        'Yellow',
        'Blue'
    ]
};
最終更新: 2023 年 4 月 28 日、午前 5 時 18 分 20 秒